message functions - continued

XgrRedrawWindow  ( window, action, xWin, yWin, width, height )

XgrRedrawWindow() calls the grid functions assigned to every parentless grid in window . It sends each a Redraw message including xWin,yWin,width,height to define the portion of the window that needs to be redrawn. The grid function can determine from xWin,yWin,width,height whether any part of the grid is in this portion of window and needs to be redrawn.

If the grid function needs to redraw the grid, it sends Redraw messages to all kids of grid, if any, passing them the same xWin,yWin,width,height arguments.

XgrRegisterMessage  ( message$, @message )

XgrRegisterMessage() returns a message number to correspond with a message$ name. If message$ is already registered, XgrRegisterEvent() returns the existing message number, otherwise it creates a new one.

XgrSendMessage  ( wingrid, message, v0, v1, v2, v3, r0, r1 )

XgrSendMessage() calls the window or grid function assigned to the window or grid in wingrid, passing it the message arguments it received.

First XgrSendMessage() examines message to determine whether the message is a window message or a grid message.

For window messages, XgrSendMessage() assumes wingrid contains a window number, looks up its window function and calls it, passing it the message arguments.

For grid message, XgrSendMessage() assumes wingrid is a grid number, looks up its grid function and calls it, passing it the message arguments.

XgrSendMessageToWindow  ( wingrid, message, v0, v1, v2, v3, r0, r1 )

XgrSendMessageToWindow() calls the window function associated with wingrid, passing it the arguments it received.

First XgrSendMessageToWindow() examines message to determine whether the message is a window or grid message.

For window messages, XgrSendMessageToWindow() assumes wingrid contains a window number, looks up its window function and calls it, passing it the message arguments.

For grid messages, XgrSendMessageToWindow() assumes wingrid contains a grid number, looks up the window function of the window that contains wingrid and calls it, passing it the message arguments.

XgrSendStringMessage  ( wingrid, message$, v0, v1, v2, v3, r0, ANY )

XgrSendStringMessage() converts the message$ string into a message number, then calls XgrSendMessage() . 

XgrSendStringMessageToWindow  ( wingrid, message$, v0, v1, v2, v3, r0, ANY )

XgrSendStringMessageToWindow() converts the message$ string into a message number, then calls XgrSetMessageToWindow() . 

XgrSetCEO  ( func )

XgrSetCEO() sets the CEO function to func, which makes func the active CEO address. func=0 cancels CEO activity. CEO functions must take exactly 8 XLONG arguments.

See XgrProcessMessages() for more information.